home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / djgpp / tktdoc / install.doc < prev    next >
Text File  |  1994-08-11  |  10KB  |  229 lines
  1. INSTALLATION AND CONFIGURATION
  2.  
  3. Please install your DESQview/X and supported compiler prior to performing
  4. the toolkit installation. If you have the GNU edition of the toolkit,
  5. the compiler is installed with the toolkit.
  6.  
  7. The OSF/Motif Toolkit system requirements are as follows:
  8.  
  9. System Requirements
  10.  
  11. A PC 386, 486 or Pentium machine.
  12.  
  13. 8MB RAM, 16MB or more recommended.
  14.  
  15. 20MB of free disk space after DESQview/X and the compiler
  16. are installed. If you intend to build many clients, demos and develop
  17. your own programs, then more disk space is required accordingly.
  18.  
  19. Installation
  20.  
  21. If you have an old DESQview/X developers toolkit installed, back it
  22. up and delete it in order not to accidentally mix files from the old
  23. and new toolkit distributions.
  24.  
  25. If you have an old version of DJGPP GNU C/C++ installed, you should
  26. back it up and delete it. Also delete old copies of go32.exe that
  27. may be in other directories on your disk. If they happen to be in
  28. your PATH, it can cause go32 programs not to execute.
  29.  
  30. If you would like to generate native floating point code with the
  31. MetaWare toolkit, then install the optional 387 libraries offered
  32. to you on the install screen. This applies to MetaWare only.
  33.  
  34. Place diskette 1 in drive A: and from the C:\DVX directory type A:\INSTALL.
  35. By default the toolkit is installed in C:\DVX. Follow the instructions
  36. in the install program. The install will offer you optional installations
  37. and will allow you to install the toolkit into an alternate directory.
  38.  
  39. Configuration
  40.  
  41. The installation will generate a batch file which sets up your environment
  42. correctly for the compiler that you have. The batch files are HIGHC.BAT
  43. for MetaWare, WATCOM.BAT for Watcom and DJGPP.BAT for DJGPP GNU.
  44.  
  45. Modify your AUTOEXEC.BAT file to invoke the appropriate batch file.
  46. This way the batch file will be invoked prior to your running DESQview/X
  47. and all DOS windows will have the proper environment setup.
  48.  
  49. Make sure you allow a minimum of 4MB of expanded memory in the DVP
  50. file for the DOS window that you are using the compiler in. If your
  51. machine has 16 MB or more of RAM, it is recommended that you allow
  52. the DOS window to use 8-16 MB of expanded memory for better compile
  53. and link times. See the DESQview/X documentation for DVPMAN.
  54.  
  55. The following is compiler-specific information.
  56.  
  57. Metaware
  58.  
  59. The HIGHC.BAT file is set up to use the HCLE model which uses the
  60. XGLU linker and generates a DOS4GX executable. If you would like to
  61. use the Phar Lap linker and DOS extender, you will need to add the
  62. Phar Lap bin directory to your path and use the Phar Lap linker commands.
  63. Refer to the Phar Lap documentation that came with the product you
  64. purchased from Phar Lap.
  65.  
  66. The X and Motif Libraries in this toolkit were built with High C/C++
  67. version 3.2. If you already have an older version than this you will
  68. need to purchase a new compiler from MetaWare. See vendor contact
  69. information in Chapter 1.
  70.  
  71. Edit the HC386SET.CNF file in your \HIGHC\BIN directory, uncomment
  72. the #args line and edit it to reflect:
  73.  
  74. args=-Hon=Pointers_compatible_with_ints \
  75.      -Hon=Pointers_compatible -Hon=Long_enums
  76.  
  77. You must also define MSDOS for compilations. If you wish you may include
  78. a -DMSDOS on the args line instead of defining it in your makefile.
  79.  
  80. The compiler toggles will be invoked whenever you invoke the compiler.
  81. They are necessary in order to compile and link X and Motif programs
  82. properly. Refer to the High C documentation for detailed descriptions
  83. of these toggles.
  84.  
  85. The previous versions of this toolkit required you to compile your
  86. MetaWare objects using the -Hloclib switch and link with the \highc\small\v1x
  87. libraries. Do not use this switch or link with these libraries.
  88.  
  89. It is subject to minor changes. Refer to the one that was installed
  90. on your system. This is the HIGHC.BAT file for the default install
  91. configuration.
  92.  
  93. set qmake=-x -f hcle
  94. set path=%PATH%;c:\highc\bin
  95. set ipath=c:\dvx\include;C:\HIGHC\inc;c:\highc\incc
  96. set lib=C:\DVX\lib\hc386;C:\HIGHC\small
  97. set no87=Not using Math co-processor
  98.  
  99. It sets the default makefile to HCLE.
  100. It adds C:\HIGHC\BIN to the path.
  101. It sets the IPATH which is the path used for
  102. header file inclusion.
  103. It sets LIB which is used by the linker to find
  104. libraries.
  105. It sets NO87 which causes the compiler to use
  106. floating point emulation.
  107.  
  108. The default for our MetaWare configuration is to use floating point
  109. emulation. This means that all objects are generated as if they had
  110. been built with the -fsoft switch. This is accomplished by having
  111. the NO87 environment variable set. If you wish to use floating point
  112. code, then you need to use the -fx87 switch and link with the X and
  113. Motif libraries which get optionally installed in the HC387 directory.
  114. If you do this, you need to change the LIB line in the batch file
  115. to:
  116.  
  117. set lib=C:\DVX\lib\hc387;C:\HIGHC\small
  118.  
  119. in order to link with the 387 libraries. You also need to remove the
  120. "set no87=..." line from the batch file and make sure that
  121. it is not set. In your makefile, the hcsoft.lib library must be replaced
  122. with the hc387.lib library. Refer to the MetaWare documentation for
  123. further details.
  124.  
  125. Watcom
  126.  
  127. The WATCOM.BAT file is set up to use the WC4G model which uses the
  128. wlink linker that came with the Watcom compiler. The WCLE model makefiles,
  129. which use the XGLU linker that generates a DOS4GX executable, are
  130. also provided with the clients and demos. If you would like to use
  131. that model all of the time, then you should modify the WATCOM.BAT
  132. file QMAKE line from "qmake=-x -f wc4g" to "qmake=-x -f
  133. wcle"
  134.  
  135. The X and Motif libraries for Watcom were built with Watcom 9.5 C/C++
  136. 32 rev B compiler. If you do not have rev B, contact Watcom for information
  137. on how to obtain the Watcom 9.5 C/C++ 32 rev A and rev B patches.
  138. See vendor contact information in Chapter 1. This toolkit is
  139. upwardly compatible to Watcom 10.0 patch level A.
  140.  
  141. When building objects using this compiler it is essential that you
  142. use the following toggles or your programs will not work and may not
  143. even compile.
  144.  
  145. /zp4 /4s /ei /DMSDOS
  146.  
  147. See the Watcom documentation for detailed descriptions of these toggles.
  148. The MSDOS define is required by the ported X11 and Motif header files.
  149. The environment variables WCC386 and WPP386 are assigned these toggles
  150. and they will be used whenever you invoke the compiler.
  151.  
  152. This is the WATCOM.BAT for the default install configuration. It is
  153. subject to minor changes. Refer to the one that was installed on your
  154. system.
  155.  
  156. set path=%PATH%;C:\WATCOM\bin;C:\WATCOM\binb
  157. set watcom=c:\watcom\.
  158. set wcc386=-zp4 -ei -4s -DMSDOS
  159. set wpp386=-zp4 -4s     -DMSDOS
  160. set qmake=-x -f wc4g
  161. set include=c:\dvx\include;C:\WATCOM\h
  162. set lib=C:\DVX\lib\c386;C:\WATCOM\lib386\dos;C:\WATCOM\lib386
  163.  
  164. It adds the watcom bin directories to the PATH.
  165. It sets the WATCOM directory which is used by the wlink linker.
  166. It sets WCC386 which defines default toggles for the C compiler.
  167. It sets WPP386 which defines default toggles for the C++ compiler.
  168. It sets the default makefile to WC4G.
  169. It sets INCLUDE which is the path used for header file inclusion.
  170. It sets LIB which is the path wlink uses to find libraries.
  171.  
  172. DJGPP GNU
  173.  
  174. The DJGPP.BAT file is setup to use the "makefile" model which
  175. uses the ld linker and the go32 DOS extender. Using this model requires
  176. that you have a DOS window of nominally 500KB in size. If you have
  177. run Optimize with DESQview/X and configured the DVP file for your
  178. DOS window to at least 500KB of conventional memory, your DOS window
  179. should be large enough.
  180.  
  181. The compile and link times can be greatly reduced if the DVP for your
  182. DOS window allows it to use 8-16 MB of expanded memory. You must,
  183. of course, have this RAM available on your system.
  184.  
  185. Additionally this model requires a DOS environment of nominally 1024
  186. bytes. Modify your CONFIG.SYS file to add the "/p /e:1024" switches
  187. to your SHELL line.
  188.  
  189. The MSDOS variable must be defined at compile time in your makefiles
  190. (i.e., gcc -DMSDOS -c myprog.c ).
  191.  
  192. This is the DJGPP.BAT file for the default install configuration.
  193. It is subject to minor changes. Refer to the one that was installed
  194. on your system.
  195.  
  196. set path=%PATH%;C:\DJGPP\bin
  197. set qmake=-x -f makefile
  198. set GO32TMP=C:\DVX\tmp
  199. set TMPDIR=C:\DVX\tmp
  200. set COMPILER_PATH=C:\DJGPP\bin
  201. set C_INCLUDE_PATH=c:\dvx\include;c:\DJGPP\include
  202. set CPLUS_INCLUDE_PATH=c:\dvx\include;c:\djgpp\cplusinc;c:\djgpp\include
  203. set LIBRARY_PATH=C:\DVX\lib\djgpp;C:\DJGPP\lib;.
  204. set BISON_SIMPLE=C:\DJGPP\lib\bison.sim
  205. set BISON_HAIRY=C:\DJGPP\lib\bison.hai
  206. set FLEX_SKELETON=C:\DJGPP\lib\flex.ske
  207.  
  208. Refer to \DJGPP\DOCS readme and doc files for DJGPP documentation.
  209.  
  210. The DJGPP distribution contains copyrighted material by the Regents
  211. of the University of California.
  212.  
  213. Testing the Installation
  214.  
  215. After the installation is completed and you have configured your system
  216. for the compiler and model you are going to use, you should verify
  217. that your installation is correct before you begin developing or porting
  218. your own applications. You can do this by compiling and running client
  219. and demo programs.
  220.  
  221. The client program XCALC and the Motif demo program PERIODIC are good
  222. programs to build to verify that your installation is correct.  See
  223. Chapter 4, Building a Sample Demo.
  224.  
  225. There are numerous clients and demos you can build that demonstrate
  226. many features of X and Motif. If you are new to X and Motif programming,
  227. then browsing through the source code of these is a good way to learn
  228. how things work.
  229.